home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / runacct.z / runacct
Encoding:
Text File  |  2002-10-03  |  11.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))                                                        rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt - run daily accounting
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt [_m_m_d_d [_s_t_a_t_e]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt is the main daily accounting shell procedure.  It is normally
  16.      initiated via _cccc_rrrr_oooo_nnnn.  _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt processes connect, fee, disk, and process
  17.      accounting files.  It also prepares summary files for _pppp_rrrr_dddd_aaaa_iiii_llll_yyyy or billing
  18.      purposes.
  19.  
  20.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt takes care not to damage active accounting files or summary files
  21.      in the event of errors.  It records its progress by writing descriptive
  22.      diagnostic messages into _a_c_t_i_v_e.  When an error is detected, a message is
  23.      written to _////_dddd_eeee_vvvv_////_cccc_oooo_nnnn_ssss_oooo_llll_eeee, mail (see _mmmm_aaaa_iiii_llll(1)) is sent to _rrrr_oooo_oooo_tttt and _aaaa_dddd_mmmm, and
  24.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt terminates.  _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt uses a series of lock files to protect
  25.      against re-invocation.  The files _llll_oooo_cccc_kkkk and _llll_oooo_cccc_kkkk_1111 are used to prevent
  26.      simultaneous invocation, and _llll_aaaa_ssss_tttt_dddd_aaaa_tttt_eeee is used to prevent more than one
  27.      invocation per day.
  28.  
  29.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt breaks its processing into separate, restartable _s_t_a_t_e_s using
  30.      _s_t_a_t_e_f_i_l_e to remember the last _s_t_a_t_e completed.  It accomplishes this by
  31.      writing the _s_t_a_t_e name into _s_t_a_t_e_f_i_l_e.  _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt then looks in _s_t_a_t_e_f_i_l_e
  32.      to see what it has done and to determine what to process next.  _s_t_a_t_e_s
  33.      are executed in the following order:
  34.  
  35.      _SSSS_EEEE_TTTT_UUUU_PPPP        Move active accounting files into working files.
  36.  
  37.      _WWWW_TTTT_MMMM_PPPP_FFFF_IIII_XXXX      Verify integrity of _wwww_tttt_mmmm_pppp file, correcting date changes if
  38.                   necessary.
  39.  
  40.      _CCCC_OOOO_NNNN_NNNN_EEEE_CCCC_TTTT      Produce connect session records in _tttt_aaaa_cccc_cccc_tttt_...._hhhh format.
  41.  
  42.      _PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS      Convert process accounting records into _tttt_aaaa_cccc_cccc_tttt_...._hhhh format.
  43.  
  44.      _MMMM_EEEE_RRRR_GGGG_EEEE        Merge the connect and process accounting records.
  45.  
  46.      _FFFF_EEEE_EEEE_SSSS         Convert output of _cccc_hhhh_aaaa_rrrr_gggg_eeee_ffff_eeee_eeee into _tttt_aaaa_cccc_cccc_tttt_...._hhhh format and merge
  47.                   with connect and process accounting records.
  48.  
  49.      _DDDD_IIII_SSSS_KKKK         Merge disk accounting records with connect, process, and fee
  50.                   accounting records.
  51.  
  52.      _MMMM_EEEE_RRRR_GGGG_EEEE_TTTT_AAAA_CCCC_CCCC_TTTT   Merge the daily total accounting records in _dddd_aaaa_yyyy_tttt_aaaa_cccc_cccc_tttt with
  53.                   the summary total accounting records in
  54.                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_tttt_aaaa_cccc_cccc_tttt.
  55.  
  56.      _CCCC_MMMM_SSSS          Produce command summaries.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))                                                        rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      _UUUU_SSSS_EEEE_RRRR_EEEE_XXXX_IIII_TTTT     Any installation dependent accounting programs can be
  75.                   included here.
  76.  
  77.      _CCCC_LLLL_EEEE_AAAA_NNNN_UUUU_PPPP      Clean up temporary files and exit.
  78.  
  79.      To restart _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt after a failure, first check the _a_c_t_i_v_e and _f_d_2_l_o_g
  80.      files for diagnostics, then fix any corrupted data files, such as _pppp_aaaa_cccc_cccc_tttt
  81.      or _wwww_tttt_mmmm_pppp.  The _llll_oooo_cccc_kkkk, _llll_oooo_cccc_kkkk_1111, and _llll_aaaa_ssss_tttt_dddd_aaaa_tttt_eeee files must be removed before
  82.      _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt can be restarted.  The argument _m_m_d_d is necessary if _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt is
  83.      being restarted, and specifies the month and day for which _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt reruns
  84.      the accounting.  The entry point for processing is based on the contents
  85.      of _s_t_a_t_e_f_i_l_e; to override this, include the desired _s_t_a_t_e on the command
  86.      line to designate where processing should begin.
  87.  
  88.      The report generation commands check the environment in order to allocate
  89.      enough memory to handle system with large configuration.  The environment
  90.      variables can be set in the appropriate _c_r_o_n_t_a_b files where _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt is
  91.      usually invoked.
  92.  
  93. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  94.      To start _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt:
  95.  
  96.           _nnnn_oooo_hhhh_uuuu_pppp _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt _2222 _>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_ffff_dddd_2222_llll_oooo_gggg _&&&&
  97.  
  98.      To restart _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt:
  99.  
  100.           _nnnn_oooo_hhhh_uuuu_pppp _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt _0000_6666_0000_1111 _2222 _>>>>_>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_ffff_dddd_2222_llll_oooo_gggg _&&&&
  101.  
  102.      To restart _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt at a specific _s_t_a_t_e:
  103.  
  104.           _nnnn_oooo_hhhh_uuuu_pppp _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt _0000_6666_0000_1111 _MMMM_EEEE_RRRR_GGGG_EEEE _2222 _>>>>_>>>> _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_ffff_dddd_2222_llll_oooo_gggg _&&&&
  105.  
  106.  
  107. FFFFIIIILLLLEEEESSSS
  108.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_wwww_tttt_mmmm_pppp
  109.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_pppp_aaaa_cccc_cccc_tttt_i_n_c_r
  110.      _////_uuuu_ssss_rrrr_////_ssss_rrrr_cccc_////_cccc_mmmm_dddd_////_aaaa_cccc_cccc_tttt_////_tttt_aaaa_cccc_cccc_tttt_...._hhhh
  111.      _////_uuuu_ssss_rrrr_////_ssss_rrrr_cccc_////_cccc_mmmm_dddd_////_aaaa_cccc_cccc_tttt_////_cccc_tttt_mmmm_pppp_...._hhhh
  112.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_aaaa_cccc_tttt_iiii_vvvv_eeee
  113.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_dddd_aaaa_yyyy_tttt_aaaa_cccc_cccc_tttt
  114.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_llll_oooo_cccc_kkkk
  115.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_llll_oooo_cccc_kkkk_1111
  116.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_llll_aaaa_ssss_tttt_dddd_aaaa_tttt_eeee
  117.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_nnnn_iiii_tttt_eeee_////_ssss_tttt_aaaa_tttt_eeee_ffff_iiii_llll_eeee
  118.  
  119. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  120.      acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M),
  121.      acctprc(1M), acctsh(1M), cron(1M), fwtmp(1M), mail(1), acct(2), acct(4),
  122.      utmp(4).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))                                                        rrrruuuunnnnaaaacccccccctttt((((1111MMMM))))
  137.  
  138.  
  139.  
  140. NNNNOOOOTTTTIIIICCCCEEEESSSS
  141.      Normally it is not a good idea to restart _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt in the _SSSS_EEEE_TTTT_UUUU_PPPP _s_t_a_t_e.
  142.      Run _SSSS_EEEE_TTTT_UUUU_PPPP manually and restart via:
  143.  
  144.           _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt _m_m_d_d _WWWW_TTTT_MMMM_PPPP_FFFF_IIII_XXXX
  145.  
  146.      If _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt failed in the _PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS _s_t_a_t_e, remove the last _pppp_tttt_aaaa_cccc_cccc_tttt file
  147.      because it is not complete.
  148.  
  149.      Each time _rrrr_uuuu_nnnn_aaaa_cccc_cccc_tttt is run, it resets the _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_wwww_tttt_mmmm_pppp file.  This make
  150.      programs like _llll_aaaa_ssss_tttt(1) less useful.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.